Integrate your payroll system

In this section you will find information on how to start build and integration mechanism between a payroll and Core HR. If you are a new Cegid HR customer you are probably already aware and maybe taking benefits of the standard connection between Cegid Payroll and Cegid HR Core HR.

But if you want more customized integration you can use our apis, or our imports.

You will have also ways to monitor integration with our logs apis, or imports logs.

Integration with a payroll

First, you'll need to define which data you want to share between your payroll and the Cegid HR suite, and then the support and the direction of the flow. We recommend to have at least theses elements of the Core HR set by your integration with your payroll system.

Classical Datasets Fields

EmployeeIDs		    
                    UniqueID
                    LegacyID 

Identity 		  
                    Gender 
                    FirstName 
                    LastName 
                    BirhtName 
                    OtherLastNames 
                    FirstNameSecond 
CivilRegistration 	
                    DateOfBirth 
                    DateOfDeath 

ContactInfo 		
                    BusinessEmail 

KeyDates 	
                    GroupStartDate
                    GroupEndDate 

PopulationType 		
                    Value
                    StartDate

Template 		
                    Template
                    StartDate

EmployeeFileStatus 
                    Status 

Situation 		
                    OccupationalCategory 
                    LineManagerUniqueID 
                    Job 
                    StartDate
                    LegalStructure 
                    Fte 
                    OrganisationalStructure 
                    GeographicOrganisationStructure
                    Collective agreement 
                    Level 
                    FtePaid 
                    Working Type

Contract
                    ContractNumber 
                    StartDate 
                    EndDate 
                    JobTitle
                    NatureOfContract 
                    Status 
                    FixedTermContractReason 
                    TerminationReason 
                    HiringReason

Main Address 		
                    Street
                    Postal Code
                    Country 
Goverment IDs	    
                    Social Security Number
Compensation
                    ....(could be annual, monthly, ...)

When a dataset is covered by an integration, ALL the fields of the data set should be "secondary" in Cegid HR to avoid possibles conflicts.

Payroll system as primary system

For complex payroll, such as the French one, it is probably the simplest choice.

By using import of csv files:

Cegid provides a private sftp for you, where you can put the csv files coming from your payroll system, and then schedule an import at the recurrence you choose.

You can also choose to use the import API, that allow you to post an import file at the moment you want, and you won't have to manage the schedule of the import, since a queue mechanism will do the work for you, keeping the order of the api call as order for the file import.

By using Inboud API:

You will have multiple endpoints. Try out our postman collection, that contains examples, dataset by dataset:

Payroll system as secondary system

If you choose to take the Core HR as primary system, You should be aware that the control of the data is lighter in the core HR than in most of the complex payroll. But it is a perfect solution to take benefit of the Employee self-service and manager self-service of the Core HR to involve employees inside our company on controlling and managing the quality of their data. You will be able to work in the Core HR intuitive layout optimized for speed and reliability highly customizable.

By using export of csv files:

Cegid provides a private sftp for you, where you can put the csv files coming from Cegid HR to be read by your payroll

The api that launch import:

You have also an api to launch import with a import file. The mechanism of import is compatible with API called simultaneously made with import by API or manuel import. API references : https://developers.cegid.com/api-details#api=ts-import-mgnt&operation=Imports_ImportFileWithFormData